home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / ftn / ssapi.z / ssapi
Encoding:
Text File  |  2002-10-03  |  4.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. SSSSSSSSAAAAPPPPIIII((((3333FFFF))))                                                            SSSSSSSSAAAAPPPPIIII((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ssrt_caliper_point, ssrt_buffer_clear - SpeedShop runtime library for
  10.      Fortran applications
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      iiiinnnntttteeeeggggeeeerrrr ssssssssrrrrtttt____ccccaaaalllliiiippppeeeerrrr____ppppooooiiiinnnntttt
  14.      iiiinnnntttteeeeggggeeeerrrr iiii,,,, ffffllllaaaaggggssss
  15.      iiii ==== ssssssssrrrrtttt____ccccaaaalllliiiippppeeeerrrr____ppppooooiiiinnnntttt((((ffffllllaaaaggggssss,,,, ''''llllaaaabbbbeeeellll''''))))
  16.      ccccaaaallllllll ssssssssrrrrtttt____bbbbuuuuffffffffeeeerrrr____cccclllleeeeaaaarrrr
  17.      ccccaaaallllllll ssssssssrrrrtttt____eeeexxxxppppeeeerrrriiiimmmmeeeennnntttt____ssssttttoooopppp
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      The SpeedShop Performance Tools work by invoking functions in the
  21.      SpeedShop runtime library.  This library may be explicitly linked with a
  22.      user program, in which case the following named routines above may be
  23.      invoked explicitly.  To explicitly link with the SpeedShop runtime, add
  24.      the option -_l_s_s to the link line used to build the program.  Doing so
  25.      will load the two SpeedShop libraries, _l_i_b_s_s._s_o and _l_i_b_s_s_r_t._s_o into the
  26.      executable.
  27.  
  28.      ssssssssrrrrtttt____ccccaaaalllliiiippppeeeerrrr____ppppooooiiiinnnntttt is used to record a caliper point in the experiment.
  29.      It may be called from anywhere in the code.  The first parameter
  30.      specifies the caliper point flags, but is not supported yet, so it's
  31.      ignored.  The second argument specifies a string label for the caliper
  32.      point.
  33.  
  34.      An implicit caliper point is always recorded at the start of execution of
  35.      the process. A final caliper point is recorded when the process exits
  36.      normally. The implicit caliper point at the beginning of the program is
  37.      numbered 0, the first caliper point after that is numbered 1, and any
  38.      additional caliper points are numbered sequentially.  In addition,
  39.      caliper points are automatically recorded under the following
  40.      circumstances to ensure that at least one valid set of data is recorded.
  41.  
  42.      - When a fatal or exit signal is received.
  43.  
  44.      - When the program calls an _e_x_e_c function.
  45.  
  46.      - When a program closes a DSO by calling _d_l_c_l_o_s_e().
  47.  
  48.      ssssssssrrrrtttt____bbbbuuuuffffffffeeeerrrr____cccclllleeeeaaaarrrr is used to clear all currently accumulated data,
  49.      resetting all values to zero.  It is used to exclude data from an
  50.      initialization phase of the program.  With caliper support available in
  51.      prof(1), this routine will normally not be used.
  52.  
  53.      ssssssssrrrrtttt____eeeexxxxppppeeeerrrriiiimmmmeeeennnntttt____ssssttttoooopppp is used to disable performance data collection for
  54.      the calling process.  No experiment file will get generated for the
  55.      process either.
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. SSSSSSSSAAAAPPPPIIII((((3333FFFF))))                                                            SSSSSSSSAAAAPPPPIIII((((3333FFFF))))
  71.  
  72.  
  73.  
  74. SEE ALSO
  75.      speedshop(1), ssrun(1), prof(1), ssdump(1), ssapi(3)
  76.  
  77. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  78.      As ouput from the library routines.
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.